

markdown配置

参考：Markdown

sphinx支持markdown，使用的是CommonMark语法

配置

需要安装recommonmark

$ pip install --upgrade recommonmark

然后在配置文件conf.py中添加Markdown解析器

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = ['recommonmark']

增加'.md'作为扩展名

source_suffix = {
    '.rst': 'restructuredtext',
    '.txt': 'markdown',
    '.md': 'markdown',
}